Getting started
Hardocs is a CLI to generate open hardware documentation templates and services. I is a set of commands to easily generate and maintain hardware documentation, with a standard project structure. The current version supports at the moment documentation in markdown, and a static site generator to show the hardware project in an intuitive way.
Prerequisites
Install node.js
Install git
to use the gitbash
Usage
make sure you have a .gitignore file at the root of your repository, and that it contains the following entries:
node_modules
/public/
\*.cvs#
Generate a static website easy to maintain with markdown that can be hosted in github or gitlab
Step 1: Install package globally
# Install the package globally
npm install hardocs -g
Step 2: Create new documentation files within your project
# Generates docs template
docz-generate
Step 3: Install packages and dependencies
npm install
Step 4: Install packages and dependencies
npm link hardocs
Step 5: Deploy locally and see your documentation on the browser
npm run start